package com.atguigu.tingshu.album;

import com.atguigu.tingshu.album.impl.AlbumDegradeFeignClient;
import com.atguigu.tingshu.common.result.Result;
import com.atguigu.tingshu.model.album.*;
import com.atguigu.tingshu.vo.album.AlbumStatVo;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;

import java.util.List;

/**
 * <p>
 * 专辑模块远程调用Feign接口
 * </p>
 *
 * @author atguigu
 */
@FeignClient(
        value = "service-album",
        contextId = "albumFeignClient",
        fallback = AlbumDegradeFeignClient.class,
        path = "/api/album"
)
public interface AlbumFeignClient {

    /**
     * 根据ID查询专辑信息
     *
     * @param id 专辑 id
     * @return 专辑信息
     */
    @GetMapping("/albumInfo/getAlbumInfo/{id}")
    Result<AlbumInfo> getAlbumInfoById(@PathVariable Long id);

    /**
     * 根据三级分类Id查询分类视图对象
     *
     * @param category3Id 三级分类Id
     * @return 分类视图对象
     */
    @GetMapping("/category/getCategoryView/{category3Id}")
    Result<BaseCategoryView> getCategoryView(@PathVariable Long category3Id);

    /**
     * 根据专辑id查询专辑统计信息
     *
     * @param albumId 专辑id
     * @return 专辑统计信息
     */
    @GetMapping("/albumInfo/getAlbumStatVo/{albumId}")
    Result<AlbumStatVo> getAlbumStatVo(@PathVariable Long albumId);


    /**
     * 查询指定1级分类下置顶前7个三级分类集合
     *
     * @param category1Id 1级分类id
     * @return 3级分类集合
     */
    @GetMapping("/category/findTopBaseCategory3/{category1Id}")
    Result<List<BaseCategory3>> findTopBaseCategory3ByCategory1Id(@PathVariable Long category1Id);

    /**
     * 查询所有一级分类列表
     *
     * @return 一级分类列表
     */
    @GetMapping("/category/findAllCategory1")
    Result<List<BaseCategory1>> getAllCategory1();

    /**
     * 根据声音ID+声音数量 获取下单付费声音列表
     *
     * @param trackId 声音ID
     * @param trackCount 声音数量
     * @return 下单付费声音列表
     */
    @GetMapping("/trackInfo/findPaidTrackInfoList/{trackId}/{trackCount}")
    Result<List<TrackInfo>> findPaidTrackInfoList(@PathVariable Long trackId, @PathVariable Integer trackCount);

    /**
     * 根据声音ID查询声音信息
     *
     * @param id 声音ID
     * @return 声音信息
     */
    @GetMapping("/trackInfo/getTrackInfo/{id}")
    Result<TrackInfo> getTrackInfoById(@PathVariable Long id);
}
